home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)TC / (A)TCA.ADF / XNote / XNote.doc < prev    next >
Text File  |  1992-07-29  |  3KB  |  67 lines
  1.  
  2.  
  3.     Since there is ENote, it is time to make the filenote more useful.
  4.     XNote (eXecute fileNote) executes the filenote of a file.  This way
  5.     you can use the filenote system in a similar way as the project icon
  6.     is used by the Workbench.  Because it is a text string that will be
  7.     executed, filenotes still will be readable and clear in its meaning.
  8.  
  9.     Because the Workbench is a bad environment for XNote, especially
  10.     under OS 1.x, execution from the Workbench is not supported.
  11.     Furthermore the Workbench has no need for a tool like XNote.  Its
  12.     real value is found in the commandline environment, which has no
  13.     simple project type so far.  
  14.  
  15.     Imagine you have a fancy printer program which can print almost
  16.     anything in any format, margins and fonts.  Beside from the file it
  17.     must print, you must give it a lot of parameters.  Let's say, you
  18.     must print address labels.  The left margin is 20 mm, the top margin
  19.     is 15 mm, the font is Universe and its size is 15 points.  A command
  20.     may look like "Print -ml20 -mt15 -u15 LabelFile".  Two months after
  21.     its first usage, you want to print that label again.  Well, now
  22.     there is XNote, making life easy.  After you found how to print the
  23.     label, you attach a filenote to the labelfile:
  24.  
  25.     > FileNote LabelFile "Print -ml20 -mt15 -u15 LabelFile"
  26.  
  27.     You now can print the label by typing:
  28.  
  29.     > XNote LabelFile
  30.  
  31.     Because the name "LabelFile" is already in use, it is known in the
  32.     environment.  XNote refers to it when it finds the char '@' in the
  33.     filenote.  Therefore the command:
  34.  
  35.     > FileNote LabelFile "Print -ml20 -mt15 -u15 @"
  36.  
  37.     has the same effect.  It is more economical with the 79 available
  38.     characters of the filenote and it automatically follows a rename of
  39.     the file.  The replacement will be put between double quotes
  40.     resulting into:
  41.  
  42.     > Print -ml20 -mt15 -u15 "LabelFile"
  43.  
  44.     This way filenames with embedded spaces are handled properly.
  45.  
  46.     If you are not content with the usage of the char '@', recompile or
  47.     just replace it in the executable.  Type "XNote" on the commandline
  48.     and a message will be printed.  The character between the single
  49.     quotes is used as the key character.  Replacing it with a hex editor
  50.     results in usage of the new character.
  51.  
  52.     A secondary result code is returned.  If the program fails, type
  53.     "why" to know why it failed.
  54.  
  55.     For demonstration purposes, things are exaggerated.  Almost all
  56.     files in this directory have executable filenotes.  Look at them
  57.     using "List" or try them out by typing "XNote <file>".
  58.  
  59.     XNote and all accompanying files are copyrighted.  XNote and all
  60.     accompanying files are freeware.  Copyright 1992 by D.W.Reisig.
  61.  
  62.     Dirk Reisig
  63.     de Woudweeren 10
  64.     1151 AV  Broek in Waterland
  65.     the Netherlands - Europe
  66.  
  67.